機會代幣訊息

介面描述

取得AI透過多資料面向，對當前行情下具有上漲潛力的代幣的追蹤訊息資料。

使用情境：

• 適用於當前行情下，對有上漲行情機會的代幣，進行AI即時追蹤的訊息查詢
• 適用於了解主力動作（入場、增持、减持、出逃等）

使用提示：

• 與機會代幣列表介面配合使用，機會代幣列表里的代幣訊號查詢才查呼叫此介面

資料更新頻率：每5分鐘更新一次

請求 URL

• 方法：POST
• 路徑：/open/v1/ai/getChanceCoinMessageList

點數消耗

• 消耗點數：5

前置條件

取得 vsTokenId

條件	說明	取得方式
已有 vsTokenId	直接使用快取的 vsTokenId，無需重複查詢	上下文自動提取
未有 vsTokenId	呼叫 POST /vs-token/list 介面取得	前置介面呼叫

請求參數

參數透過請求體（Body）以 JSON 格式傳遞。

參數名	類型	必需	描述
vsTokenId	long	是	代幣 ID

回應欄位

僅展示 data 陣列內每個物件的欄位結構：

欄位	類型	實際回傳類型	描述
updateTime	long	long	更新時間（毫秒時間戳）
vsTokenId	long	string	VS Token ID
symbol	string	string	代幣符號
name	string	string	代幣名稱
chanceMessageType	integer	integer	預測類型
scoring	number	number	得分
grade	integer	integer	等級
price	number	string	幣價
percentChange24h	number	number	24 小時跌漲幅
gains	number	number	漲幅
decline	number	number	跌幅

欄位業務含義

欄位	業務含義	使用建議
chanceMessageType	機會訊息類型	識別主力動作類型，如入場、增持、减持、出逃等
scoring	機會得分	該訊號的綜合評分，分數越高訊號越強
grade	機會等級	訊號等級划分，用於篩選重要訊號

請求範例

{
    "vsTokenId": 23335      // 代币id
}

cURL 範例（Linux/macOS）

curl --location --request POST 'http://${host}/api/open/v1/ai/getChanceCoinMessageList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 23335
}'

cURL 範例（Windows CMD）

curl --location --request POST "http://${host}/api/open/v1/ai/getChanceCoinMessageList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 23335}"

成功回應範例

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "updateTime": 1773071700000,       // 更新时间
            "vsTokenId": "23335",                // VS Token ID
            "symbol": "THE",                      // 代币符号
            "name": "THENA",                      // 代币名称
            "chanceMessageType": 30,                    // 预测类型
            "scoring": 0.0,                       // 得分
            "grade": 2,                           // 等级
            "price": "0.2742",                    // 币价
            "percentChange24h": 6.18293206,       // 24 小时跌涨幅
            "gains": 5.0743990000000005,          // 涨幅
            "decline": 0.363108                    // 跌幅
        },
        {
            "updateTime": 1773016500000,
            "vsTokenId": "23335",
            "symbol": "THE",
            "name": "THENA",
            "chanceMessageType": 5,
            "scoring": 45.0,
            "grade": 2,
            "price": "0.2621",
            "percentChange24h": 0.44075617,
            "gains": 0.0,
            "decline": 0.0
        }
    ],
    "requestId": "xxx-xxx-xxx"
}